<!DOCTYPE html>



  


<html class="theme-next mist use-motion" lang="zh-Hans">
<head>
  <meta charset="UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>
<meta name="theme-color" content="#222">



  
  
    
    
  <script src="/kunkun/lib/pace/pace.min.js?v=1.0.2"></script>
  <link href="/kunkun/lib/pace/pace-theme-minimal.min.css?v=1.0.2" rel="stylesheet">







<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />















  
  
  <link href="/kunkun/lib/fancybox/source/jquery.fancybox.css?v=2.1.5" rel="stylesheet" type="text/css" />




  
  
  
  

  
    
    
  

  

  

  

  

  
    
    
    <link href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic&subset=latin,latin-ext" rel="stylesheet" type="text/css">
  






<link href="/kunkun/lib/font-awesome/css/font-awesome.min.css?v=4.6.2" rel="stylesheet" type="text/css" />

<link href="/kunkun/css/main.css?v=5.1.2" rel="stylesheet" type="text/css" />


  <meta name="keywords" content="java,注解," />








  <link rel="shortcut icon" type="image/x-icon" href="/kunkun/favicon.ico?v=5.1.2" />






<meta name="description" content="注解是什么 Java1.5引入了注解，当前许多java框架中大量使用注解，如Hibernate、Jersey、Spring。注解作为程序的元数据嵌入到程序当中。注解可以被一些解析工具或者是编译工具进行解析。我们也可以声明注解在编译过程或执行时产生作用。在使用注解之前，程序源数据只是通过java注释和javadoc，但是">
<meta name="keywords" content="java,注解">
<meta property="og:type" content="article">
<meta property="og:title" content="java注解知识梳理">
<meta property="og:url" content="http://yoursite.com/2017/11/30/java注解知识梳理/index.html">
<meta property="og:site_name" content="hasaki">
<meta property="og:description" content="注解是什么 Java1.5引入了注解，当前许多java框架中大量使用注解，如Hibernate、Jersey、Spring。注解作为程序的元数据嵌入到程序当中。注解可以被一些解析工具或者是编译工具进行解析。我们也可以声明注解在编译过程或执行时产生作用。在使用注解之前，程序源数据只是通过java注释和javadoc，但是注解提供的功能要远远超过这些。注解不仅包含了元数据，它还可以作用于程序运行过程中">
<meta property="og:locale" content="zh-Hans">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301235_295.png">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301308_870.png">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301310_251.png">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301315_531.png">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301317_939.png">
<meta property="og:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301320_96.jpg">
<meta property="og:updated_time" content="2017-11-30T05:30:50.120Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="java注解知识梳理">
<meta name="twitter:description" content="注解是什么 Java1.5引入了注解，当前许多java框架中大量使用注解，如Hibernate、Jersey、Spring。注解作为程序的元数据嵌入到程序当中。注解可以被一些解析工具或者是编译工具进行解析。我们也可以声明注解在编译过程或执行时产生作用。在使用注解之前，程序源数据只是通过java注释和javadoc，但是注解提供的功能要远远超过这些。注解不仅包含了元数据，它还可以作用于程序运行过程中">
<meta name="twitter:image" content="http://ozypoe1ag.bkt.clouddn.com/201711301235_295.png">



<script type="text/javascript" id="hexo.configurations">
  var NexT = window.NexT || {};
  var CONFIG = {
    root: '/kunkun/',
    scheme: 'Mist',
    sidebar: {"position":"right","display":"hide","offset":12,"offset_float":12,"b2t":false,"scrollpercent":false,"onmobile":false},
    fancybox: true,
    tabs: true,
    motion: true,
    duoshuo: {
      userId: '0',
      author: '博主'
    },
    algolia: {
      applicationID: '',
      apiKey: '',
      indexName: '',
      hits: {"per_page":10},
      labels: {"input_placeholder":"Search for Posts","hits_empty":"We didn't find any results for the search: ${query}","hits_stats":"${hits} results found in ${time} ms"}
    }
  };
</script>



  <link rel="canonical" href="http://yoursite.com/2017/11/30/java注解知识梳理/"/>





  <title>java注解知识梳理 | hasaki</title>
  














</head>

<body itemscope itemtype="http://schema.org/WebPage" lang="zh-Hans">

  
  
    
  

  <div class="container sidebar-position-right page-post-detail ">
    <div class="headband"></div>

    <a href="https://github.com/kun95"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/e7bbb0521b397edbd5fe43e7f760759336b5e05f/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677265656e5f3030373230302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_green_007200.png"></a>

    <header id="header" class="header" itemscope itemtype="http://schema.org/WPHeader">
      <div class="header-inner"><div class="site-brand-wrapper">
  <div class="site-meta ">
    

    <div class="custom-logo-site-title">
      <a href="/kunkun/"  class="brand" rel="start">
        <span class="logo-line-before"><i></i></span>
        <span class="site-title">hasaki</span>
        <span class="logo-line-after"><i></i></span>
      </a>
    </div>
      
        <p class="site-subtitle">求知若渴，虚心若愚</p>
      
  </div>

  <div class="site-nav-toggle">
    <button>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
    </button>
  </div>
</div>

<nav class="site-nav">
  

  
    <ul id="menu" class="menu">
      
        
        <li class="menu-item menu-item-home">
          <a href="/kunkun/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-home"></i> <br />
            
            首页
          </a>
        </li>
      
        
        <li class="menu-item menu-item-categories">
          <a href="/kunkun/categories/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-th"></i> <br />
            
            分类
          </a>
        </li>
      
        
        <li class="menu-item menu-item-archives">
          <a href="/kunkun/archives/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-archive"></i> <br />
            
            归档
          </a>
        </li>
      
        
        <li class="menu-item menu-item-tags">
          <a href="/kunkun/tags/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-tags"></i> <br />
            
            标签
          </a>
        </li>
      

      
        <li class="menu-item menu-item-search">
          
            <a href="javascript:;" class="popup-trigger">
          
            
              <i class="menu-item-icon fa fa-search fa-fw"></i> <br />
            
            搜索
          </a>
        </li>
      
    </ul>
  

  
    <div class="site-search">
      
  <div class="popup search-popup local-search-popup">
  <div class="local-search-header clearfix">
    <span class="search-icon">
      <i class="fa fa-search"></i>
    </span>
    <span class="popup-btn-close">
      <i class="fa fa-times-circle"></i>
    </span>
    <div class="local-search-input-wrapper">
      <input autocomplete="off"
             placeholder="搜索..." spellcheck="false"
             type="text" id="local-search-input">
    </div>
  </div>
  <div id="local-search-result"></div>
</div>



    </div>
  
</nav>



 </div>
    </header>

    <main id="main" class="main">
      <div class="main-inner">
        <div class="content-wrap">
          <div id="content" class="content">
            

  <div id="posts" class="posts-expand">
    

  

  
  
  

  <article class="post post-type-normal" itemscope itemtype="http://schema.org/Article">
  
  
  
  <div class="post-block">
    <link itemprop="mainEntityOfPage" href="http://yoursite.com/kunkun/2017/11/30/java注解知识梳理/">

    <span hidden itemprop="author" itemscope itemtype="http://schema.org/Person">
      <meta itemprop="name" content="hasaki">
      <meta itemprop="description" content="">
      <meta itemprop="image" content="/kunkun/images/touxiang.jpg">
    </span>

    <span hidden itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="hasaki">
    </span>

    
      <header class="post-header">

        
        
          <h1 class="post-title" itemprop="name headline">java注解知识梳理</h1>
        

        <div class="post-meta">
          <span class="post-time">
            
              <span class="post-meta-item-icon">
                <i class="fa fa-calendar-o"></i>
              </span>
              
                <span class="post-meta-item-text">发表于</span>
              
              <time title="创建于" itemprop="dateCreated datePublished" datetime="2017-11-30T11:16:15+08:00">
                2017-11-30
              </time>
            

            

            
          </span>

          
            <span class="post-category" >
            
              <span class="post-meta-divider">|</span>
            
              <span class="post-meta-item-icon">
                <i class="fa fa-folder-o"></i>
              </span>
              
                <span class="post-meta-item-text">分类于</span>
              
              
                <span itemprop="about" itemscope itemtype="http://schema.org/Thing">
                  <a href="/kunkun/categories/java基础/" itemprop="url" rel="index">
                    <span itemprop="name">java基础</span>
                  </a>
                </span>

                
                
              
            </span>
          

          
            
            <!--noindex-->
              <span class="post-comments-count">
                <span class="post-meta-divider">|</span>
                <span class="post-meta-item-icon">
                  <i class="fa fa-comment-o"></i>
                </span>
                <a href="/kunkun/2017/11/30/java注解知识梳理/#comments" itemprop="discussionUrl">
                  <span class="post-comments-count hc-comment-count" data-xid="2017/11/30/java注解知识梳理/" itemprop="commentsCount"></span>
                </a>
              </span>
              <!--/noindex-->
            
          

          
          

          
            <span class="post-meta-divider">|</span>
            <span class="page-pv">本文总阅读量
            <span class="busuanzi-value" id="busuanzi_value_page_pv" ></span>
            </span>
          

          

          

        </div>
      </header>
    

    
    
    
    <div class="post-body" itemprop="articleBody">

      
      

      
        <h3 id="注解是什么"><a href="#注解是什么" class="headerlink" title="注解是什么"></a>注解是什么</h3><blockquote>
<p>Java1.5引入了注解，当前许多java框架中大量使用注解，如Hibernate、Jersey、Spring。注解作为程序的元数据嵌入到程序当中。注解可以被一些解析工具或者是编译工具进行解析。我们也可以声明注解在编译过程或执行时产生作用。<br>在使用注解之前，程序源数据只是通过java注释和javadoc，但是注解提供的功能要远远超过这些。注解不仅包含了元数据，它还可以作用于程序运行过程中、注解解释器可以通过注解决定程序的执行顺序。</p>
</blockquote>
<a id="more"></a>
<h3 id="注解优缺点"><a href="#注解优缺点" class="headerlink" title="注解优缺点"></a>注解优缺点</h3><h4 id="优点"><a href="#优点" class="headerlink" title="优点"></a>优点</h4><ul>
<li>开发速度快</li>
<li>编译期间容易发现错误的出处</li>
</ul>
<h4 id="缺点"><a href="#缺点" class="headerlink" title="缺点"></a>缺点</h4><ul>
<li>管理分散，基本每个类上都有</li>
</ul>
<h3 id="说明"><a href="#说明" class="headerlink" title="说明"></a>说明</h3><p>有些注解只是为了防止我们犯低级错误，通过这些注解，让编译器在编译期就可以检查出一些低级错误，对于这些注解，可以加或者不加，当然还有很多其他注解都是起辅助编程作用。但是有一些注解的作用很重要，不加的话就实现不了一些功能，比如，数据持久化操作中，通过@Entity注解来标识持久化实体类，如果不使用该注解程序就识别不了持久化实体类。</p>
<p>注解可以提供元数据，但是提供元数据并非只能通过注解，通过配置文件也可以。比如还是下面代码id这个变量，我现在想为它添加描述数据即元数据，内容是：采用自增策略。这个信息通过Annotation来实现的话就是<code>@GeneratedValue(strategy=GenerationType.AUTO)</code>的形式。通过配置文件实现的话，比如采用xml格式配置文件。那么我可以在文件中配置<property-metadata class="Book " property="id" metadata="auto">。哈哈！比如我就定一个规则：class表示类，property表示类的某个属性，metadata是属性的元数据。程序在启动时通过读取这个文件的信息就可以知道id变量的元数据了，知道元数据就可以做相应处理了。当然，通过配置文件还是没有注解方便。</property-metadata></p>
<pre><code>@Entity
public class Book {
    @Id
    @GeneratedValue(strategy=GenerationType.AUTO)
    private Long id;
}
</code></pre><h3 id="基本知识"><a href="#基本知识" class="headerlink" title="基本知识"></a>基本知识</h3><h4 id="5个基本Annotation"><a href="#5个基本Annotation" class="headerlink" title="5个基本Annotation"></a>5个基本Annotation</h4><p>java提供了5个基本的Annotation的用法，在使用Annotation时要在其前面增加@符号。</p>
<pre><code>@Override ：限定重写父类方法
@Deprecated：表示已过时
@SuppressWarnings：抑制编译警告
@SafeVarargs (java7新增）：去除“堆污染”警告
@Functionlnterface （java8新增）：修饰函数式接口
</code></pre><p>@Override ：用来指定方法覆载的，它可以强制一个子类必须覆盖父类的方法。写在子类的方法上，在编译期，编译器检查这个方法，保证父类包含被该方法重写的方法，否则编译出错。该注解只能修饰方法，在编译期被读取。</p>
<p>@Deprecated：用于表示某个程序元素（类、方法等）已过时。编译时读取，编译器编译到过时元素会给出警告。</p>
<p>@SuppressWarnings：抑制编译警告，被该注解修饰的程序元素（以及该程序元素中的所有子元素）取消显示指定的编译警告。<br>比如：取消如果程序使用没有泛型限制的集合会引起编译器警告，为了避免这种警告使用该注解。</p>
<p>unchecked异常：运行时异常。是RuntimeException的子类，<strong>不需要在代码中显式地捕获unchecked异常做处理</strong>。</p>
<pre><code>@SuppressWarnings(value=&quot;unchecked&quot;)
public class SuppressWarningTest{
   public static void main(String[] args)
   {
       List&lt;String&gt; myList = new ArrayList();
   }
}
@SuppressWarnings(&quot;deprecation&quot;)   //取消过时警告
    public HibernateTemplate getHt() {
        return ht;
    }
</code></pre><p>@SafeVarargs (java7新增）：java7的“堆污染”警告与@SafeVarargs<br>堆污染：把一个不带泛型的对象赋给一个带泛型的变量是，就会发生堆污染。<br>例如：下面代码引起堆污染，会给出警告</p>
<pre><code>List l2 = new ArrayList&lt;Number&gt;();
List&lt;String&gt; ls = l2;
</code></pre><p>3中方式去掉这个警告</p>
<pre><code>使用注解@SafeVarargs修饰引发该警告的方法或构造器。
使用@SuppressWarnings(&quot;unchecked&quot;) 修饰。
使用编译器参数命令：-Xlint:varargs
</code></pre><p>@Functionlnterface （java8新增）：修饰函数式接口<br>使用该注解修饰的接口必须是函数式接口，不然编译会出错。那么什么是函数式接口？</p>
<blockquote>
<p>答：如果接口中只有一个抽象方法（可以包含多个默认方法或static方法），就是函数式接口。<br>如：</p>
</blockquote>
<pre><code>@Functionlnterface
public interface FunInterface{
static void foo(){
 System.out.println(&quot;foo类方法&quot;);
}
default void bar(){
 System.out.println(&quot;bar默认方法&quot;);
}
void test();//只定义一个抽象方法，默认public
}
</code></pre><h4 id="6个元Annotation"><a href="#6个元Annotation" class="headerlink" title="6个元Annotation"></a>6个元Annotation</h4><p>元注解(Meta Annotation)：和元数据一样，修饰注解的注解。java提供了6个元注解（Meta Annotation)，在java.lang.annotation中。其中5个用于修饰其他的Annonation定义。而@Repeatable专门用于定义Java8新增的重复注解。所以要定义注解必须使用到5个元注解来定义。</p>
<pre><code>@Retention
@Target
@Documented
@Inherited
未知
@Repeatable (jdk8新增)
</code></pre><p>@Retention（英文：保留）</p>
<p>用于指定被修饰的Annotation可以保留多长时间，只能修饰Annotation定义。@Retention包含一个RetentionPolicy类型的value成员变量，使用@Retention必须为该value成员变量指定值。value成员变量的值有3个选择：</p>
<pre><code>RetentionPolicy.CLASS:编译器将把Annotation记录在class文件中。当运行java程序时，JVM不可获取Annotation信息。（默认值）
RetentionPolicy.RUNTIME:编译器将把Annotation记录在class文件中。当运行java程序时，JVM也可获取Annotation信息，程序可以通过反射获取该Annotation信息
RetentionPolicy.SOURCE:Annotation只保留在源代码中（.java文件中），编译器直接丢弃这种Annotation。
</code></pre><p>案例：<br>//定义下面的Testable Annotation保留到运行时，也可以使用value=RetentionPolicy.RUNTIME</p>
<pre><code>@Retention(RetentionPolicy.RUNTIME)
public @interface Testable{}
</code></pre><p>@Target ( 目标)</p>
<p>用于指定被修饰的Annotation能用于修饰哪些程序单元，只能修饰Annotation定义。它包含一个名为value的成员变量，取值如下：</p>
<pre><code>@Target(ElementType.ANNOTATION_TYPE)：指定该该策略的Annotation只能修饰Annotation.
@Target(ElementType.TYPE) //接口、类、枚举、注解
@Target(ElementType.FIELD) //成员变量（字段、枚举的常量）
@Target(ElementType.METHOD) //方法
@Target(ElementType.PARAMETER) //方法参数
@Target(ElementType.CONSTRUCTOR) //构造函数
@Target(ElementType.LOCAL_VARIABLE)//局部变量
@Target(ElementType.PACKAGE) ///修饰包定义
@Target(ElementType.TYPE_PARAMETER) //java8新增，后面Type Annotation有介绍
@Target(ElementType.TYPE_USE) ///java8新增，后面Type Annotation有介绍
</code></pre><p>@Documented</p>
<p>用于指定被修饰的Annotation将被javadoc工具提取成文档。即说明该注解将被包含在javadoc中。</p>
<p>@Inherited</p>
<p>用于指定被修饰的Annotation具有继承性。即子类可以继承父类中的该注解。—》注解@WW被元注解@Inherited修饰，把@WW添加在类Base上，则Base的所有子类也将默认使用@WW注解。</p>
<h3 id="如何自定义注解"><a href="#如何自定义注解" class="headerlink" title="如何自定义注解"></a>如何自定义注解</h3><ol>
<li>使用@interface关键字</li>
<li>编写注解处理器（如果需要对自定义注解做处理的话）</li>
<li>注解放在修饰元素的上面</li>
</ol>
<h4 id="一个简单的注解"><a href="#一个简单的注解" class="headerlink" title="一个简单的注解"></a>一个简单的注解</h4><pre><code>//定义一个简单的注解Test
public @interface Test{}
</code></pre><p><strong>默认情况下，Annotation可以修饰任何程序元素:类、接口、方法等。</strong></p>
<pre><code>@Test
public class MyClass{

}
</code></pre><h4 id="带成员变量的注解"><a href="#带成员变量的注解" class="headerlink" title="带成员变量的注解"></a>带成员变量的注解</h4><p>以无形参的方法形式来声明Annotation的成员变量，方法名和返回值定义了成员变量名称和类型。使用default关键字设置初始值。<strong>没设置初始值的变量则使用时必须提供</strong>，有初始值的变量可以设置也可以不设置。</p>
<pre><code>//定义带成员变量注解MyTag
@Rentention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyTag{
  //定义两个成员变量，以方法的形式定义
  String name();
  int age() default 32;
}

//使用
public class Test{
  @MyTag(age=&quot;32&quot;,name=&quot;liang&quot;)
  public void info(){}
}
</code></pre><h4 id="结论"><a href="#结论" class="headerlink" title="结论"></a>结论</h4><blockquote>
<p>没带成员变量的Annotation被称为标记，这种注解仅利用自身的存在与否来提供信息，如@Override等。<br>包含成员变量的Annotation称为元数据Annotation,因为他们提供更多元数据。</p>
</blockquote>
<h3 id="如何提取注解信息"><a href="#如何提取注解信息" class="headerlink" title="如何提取注解信息"></a>如何提取注解信息</h3><p>这个是编写注解处理器的前提，只有能拿到注解的相关信息，才能用这些信息对被注解的对象做自定义的处理。提取注解信息的技术基础是反射技术。</p>
<ul>
<li>使用Annotation修饰了类、方法、成员变量等程序元素之后，<strong>这些Annotation不会自己生效</strong>，必须由开发者通过API来提取并处理Annotation信息。</li>
<li>Annotation接口是所有注解的父接口。</li>
</ul>
<p>思路：通过反射获取Annotation，将Annotation转换成具体的注解类，在调用注解类定义的方法获取元数据信息。</p>
<p>获取Annotation</p>
<p>AnnotatedElement接口(java.lang.reflect反射包中)<strong>代表程序中可以接受注解的程序元素</strong>。即所有可以接受注解的程序元素都会实现该接口。而该接口就提供了获取Annotation的方法，它的所有实现类也便拥有了这些方法。常见的实现类：</p>
<pre><code>Class:类定义。
Constructor:构造器定义
Field:类的成员变量定义
Method:类的方法定义。
Package:类的包定义。
</code></pre><p><img src="http://ozypoe1ag.bkt.clouddn.com/201711301235_295.png" alt=""></p>
<p>由此可见，AnnotatedElement接口的实现类都是一些反射技术设计到的类，<strong>所以访问Annotation信息也是通过反射技术来实现的。</strong></p>
<p><code>java.lang.reflect</code>包下还包含实现反射功能的工具类，java5开始，<code>java.lang.reflect</code>包提供的反射API增加了读取允许Annotation的能力。但是，只有定义Annotation时使用了<code>@Rentention(RetentionPolicy.RUNTIME)</code>修饰，该Annotation才会在运行时可见，JVM才会在装载*.class文件时读取保存在class文件中的Annotation。</p>
<p>AnnotatedElement接口获取Annotation信息的方法：</p>
<pre><code>&lt;T extends Annotation&gt; T getAnnotation(Class&lt;T&gt; annotationClass)：返回修饰该程序元素的指定类型的注解，不存在则返回 null。
&lt;T extends Annotation&gt; T getDeclaredAnnotation(Class&lt;T&gt; annotationClass)：返回直接修饰该程序元素的指定类型的注解，不存在则返回 null。 （java8新增）
Annotation[] getAnnotations()：返回此元素上存在的所有注解。
Annotation[] getDeclaredAnnotations()：返回直接存在于此元素上的所有注解。
boolean isAnnotationPresent (Class&lt; ? extends Annotation&gt; annotationClass)：如果指定类型的注解存在于此元素上，则返回 true，否则返回 false。
java8新增了重复注解功能，所以下面两个方法在java8之后才有：
&lt;T extends Annotation&gt; T[] getAnnotationsByType(Class&lt;T&gt; annotationClass)：返回修饰该程序元素的指定类型的多个注解，不存在则返回 null。
&lt;T extends Annotation&gt; T[] getDeclaredAnnotationsByType(Class&lt;T&gt; annotationClass)：返回直接修饰该程序元素的指定类型的多个注解，不存在则返回 null。
</code></pre><p>案例</p>
<p>需求：获取Test类的info方法上的所有注解，并打印出来，如果包含有前面我们定义的MyTag注解，则再输出MyTag注解的元数据。</p>
<p>实现：正如我们所知，仅在程序中使用注解是不起任何作用的，必须使用注解处理工具来处理程序中的注解。下面就写一个注解处理类。处理注解的思路如下：通过反射获取Test的类描述类Class，然后在获取其info方法描述类Method，因为Method实现了AnnotatedElement接口，所以调用getAnnotations方法获取所有注解，在遍历打印。</p>
<p>MyTag注解处理器</p>
<pre><code>public class MyTagAnnotationProcessor {
    public static void process(String className) throws ClassNotFoundException{
        try {
             Class clazz =Class.forName(className);
             Annotation[] aArray= clazz.getMethod(&quot;info&quot;).getAnnotations();
             for( Annotation an :aArray){
                 System.out.println(an);//打印注解
                 if( an instanceof MyTag){
                     MyTag tag = (MyTag) an;
                     System.out.println(&quot;tag.name():&quot;+tag.name());
                     System.out.println(&quot;tag.age():&quot;+tag.age());
                 }
             }
        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        } catch (SecurityException e) {
            e.printStackTrace();
        }
    }
}
</code></pre><p>场景测试</p>
<pre><code>public static void main(String[] args) {
        try {
            MyTagAnnotationProcessor.process(&quot;annotation.Test&quot;);
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
    }
</code></pre><p>测试结果</p>
<pre><code>@annotation.MyTag(age=32, name=liang)
tag.name():liang
tag.age():32
</code></pre><h3 id="Java8新增的重复注解"><a href="#Java8新增的重复注解" class="headerlink" title="Java8新增的重复注解"></a>Java8新增的重复注解</h3><p>在java8以前，同一个程序元素只能使用一个相同类型的Annotation。如下代码是错误的。</p>
<pre><code>//代码错误，不可以使用相同注解在一个程序元素上。
@MyTag(name=&quot;liang&quot;)
@MyTag(name=&quot;huan&quot;)
public void info(){
}
</code></pre><h4 id="java8之前实现思路"><a href="#java8之前实现思路" class="headerlink" title="java8之前实现思路"></a>java8之前实现思路</h4><p>要想达到使用多个注解的目的，可以使用注解”容器“：其实就是新定义一个注解DupMyTag ，让这个DupMyTag 注解的成员变量value的类型为注解MyTag数组。这样就可以通过注解DupMyTag 使用多个注解MyTag了。换个思路实现，只是书写形式不一样而已。</p>
<p>操作步骤2步：1</p>
<ul>
<li>编写需要重复的注解@MyTag，上面定义过了。</li>
<li>编写”容器“注解DupMyTag 。</li>
</ul>
<p>如下DupMyTag 注解：</p>
<pre><code>@Retention(RetentionPolicy.RUNTIME)
@Target(value=ElementType.METHOD)
public @interface DupMyTag {
  //成员变量为MyTag数组类型
  MyTag[] value();
}
</code></pre><p>使用@DupMyTag，为@DupMyTag 注解的成员变量设置多个@MyTag注解，从而达到效果。</p>
<pre><code>//代码正确，换个思路实现，在同一个程序元素上使用了多个相同的注解MyTag
@DupMyTag ({ @MyTag(name=&quot;liang&quot;),@MyTag(name=&quot;huan&quot;,age=18)})
public void info(){
}
</code></pre><p>打印注解输出内容如下：</p>
<pre><code>@annotation.DupMyTag(value=[@annotation.MyTag(age=25, name=liang), @annotation.MyTag(age=18, name=huan)])
</code></pre><p>结论：通过新定义一个容器注解，来实现使用多个相同注解的目的，只是书写形式不能达到期待效果而已，要想书写形式能达到期待效果需要使用java8之后的@Repeatable元注解。</p>
<p>注：<strong>”容器“注解的保留期Retention必须比它所包含注解的保留期更长，否则编译报错</strong></p>
<h4 id="java8之后实现重复注解"><a href="#java8之后实现重复注解" class="headerlink" title="java8之后实现重复注解"></a>java8之后实现重复注解</h4><p>java8之后新增了@Repeatable元注解，用来开发重复注解，其有一个必填Class类型变量value。</p>
<p>同样，还是需要新定义一个注解@DupMyTag。和上面定义的一样。不一样的是@Repeatable元注解需要加在@MyTag上，value值设置为DupMyTag.class，开发便完成。</p>
<p>操作步骤2步：</p>
<ul>
<li>编写需要重复的注解@MyTag，如下。</li>
<li>编写”容器“注解DupMyTag ，上面定义过了</li>
</ul>
<p>如下：通过@Repeatable定义了一个重复注解@MyTag。</p>
<pre><code>//定义带成员变量注解MyTag
@Repeatable(DupMyTag.class)
@Rentention(RetentionPolicy.RUNTIME)
@Method(ElementType.METHOD)
public @interface MyTag{
//定义两个成员变量，以方法的形式定义
String name();
int age() default 32;
}
</code></pre><p>使用,书写形式达到了理想效果，当然上面的形式依然可以使用</p>
<pre><code>@MyTag(name=&quot;liang&quot;)
@MyTag(name=&quot;huan&quot;,age =18)
public void info(){
}
//两种形式都可以
@DupMyTag ({ @MyTag(name=&quot;liang&quot;),@MyTag(name=&quot;huan&quot;,age=18)})
public void info(){
}
</code></pre><p>原理：系统依然还是将两个MyTag注解作为DupMyTag的value成员变量的数组元素，只是书写形式多了一种而已</p>
<h4 id="获取重复注解方法"><a href="#获取重复注解方法" class="headerlink" title="获取重复注解方法"></a>获取重复注解方法</h4><p>上面代码通过getDeclaredAnnotationsByType(MyTag.class)和getDeclaredAnnotation(DupMyTag.class)两个方法都能获取到值，只是结果不一样如下：</p>
<p>@annotation.MyTag(age=25, name=liang)<br>@annotation.MyTag(age=18, name=huan)<br>@annotation.DupMyTag(value=[@annotation.MyTag(age=25, name=liang), @annotation.MyTag(age=18, name=huan)])</p>
<h3 id="Java8新增的Type-Annotation注解"><a href="#Java8新增的Type-Annotation注解" class="headerlink" title="Java8新增的Type Annotation注解"></a>Java8新增的Type Annotation注解</h3><h4 id="介绍"><a href="#介绍" class="headerlink" title="介绍"></a>介绍</h4><p>目的：以前的注解只能用在包、类、构造器、方法、成员变量、参数、局部变量。<strong>如果想在：创建对象（通过new创建）、类型转换、使用implements实现接口、使用throws声明抛出异常的位置使用注解就不行了。而Type Annotation注解就为了这个而来。
</strong><br>抽象表述： java为ElementType枚举增加了TYPE_PARAMETER、TYPE_USE两个枚举值。@Target(TYPE_USE)修饰的注解称为Type Annotation(类型注解），<strong>Type Annotation可用在任何用到类型的地方。</strong></p>
<h4 id="案例"><a href="#案例" class="headerlink" title="案例"></a>案例</h4><p>定义一个类型注解NotNull</p>
<pre><code>@Target(ElementType.TYPE_USE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface NotNull {
    String value() default &quot;&quot;;
}
</code></pre><p>使用</p>
<pre><code>//implements实现接口中使用Type Annotation
public class Test implements @NotNull(value=&quot;Serializable&quot;) Serializable{

      //泛型中使用Type Annotation  、   抛出异常中使用Type Annotation
  public  void foo(List&lt;@NotNull String&gt; list) throws @NotNull(value=&quot;ClassNotFoundException&quot;) ClassNotFoundException {
      //创建对象中使用Type Annotation
      Object obj =new @NotNull String(&quot;annotation.Test&quot;);
      //强制类型转换中使用Type Annotation
      String str = (@NotNull String) obj;
  }
}
</code></pre><p>编写处理注解的处理器。<br>java8提供AnnotatedType接口，该接口用来代表被注解修饰的类型。该接口继承AnnotatedElement接口。同时多了一个public Type getType()方法，用于返回注解修饰的类型。</p>
<p>以下处理器只处理了类实现接口处的注解和throws声明抛出异常处的注解。</p>
<pre><code>/*
类说明 NotNull注解处理器，只处理了implements实现接口出注解、throws声明抛出异常出的注解。
*/
public class NotNullAnnotationProcessor {

    public static void process(String className) throws ClassNotFoundException{
        try {
            Class clazz =Class.forName(className);
            //获取类继承的、带注解的接口
            AnnotatedType[] aInterfaces =clazz.getAnnotatedInterfaces();
            print(aInterfaces);

            Method method = clazz.getMethod(&quot;foo&quot;);
            //获取方法上抛出的带注解的异常
            AnnotatedType[] aExceptions =method.getAnnotatedExceptionTypes();
            print(aExceptions);

        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        } catch (SecurityException e) {
            e.printStackTrace();
        }
    }
    /**
     * 打印带注解类型
     * @param array
     */
    public static void print(AnnotatedType[] array){
        for( AnnotatedType at : array){
            Type type =at.getType();//获取基础类型
            Annotation[] ans =at.getAnnotations();//获取注解
            //打印类型
            System.out.println(type);
            //打印注解
            for( Annotation an : ans){
                System.out.println(an);
            }
            System.out.println(&quot;------------&quot;);
        }
    }
}
</code></pre><p>打印结果</p>
<pre><code>interface java.io.Serializable
@annotation.NotNull(value=Serializable)
------------
class java.lang.ClassNotFoundException
@annotation.NotNull(value=ClassNotFoundException)
------------
</code></pre><h3 id="编译时处理Annotation"><a href="#编译时处理Annotation" class="headerlink" title="编译时处理Annotation"></a>编译时处理Annotation</h3><h4 id="需求"><a href="#需求" class="headerlink" title="需求"></a>需求</h4><p>有过Hibernate开发经验的朋友可能知道每写一个Java文件，还必须额外地维护一个Hibernate映射文件(一个名为<code>*.hbm.xml</code>的文件,当然可以有一些工具可以自动生成)下面将使用Annotation来简化这步操作。思路：自定义修饰类的注解，在实体类上使用注解，编写注解处理器：根据源文件中的类上的注解，生成<code>*.hbm.xml</code>文件，使用java提供的编译命令javac执行注解处理器。<strong>关键：编写注解处理器</strong>。</p>
<h4 id="可用api"><a href="#可用api" class="headerlink" title="可用api"></a>可用api</h4><p>我们知道前面的注解处理器处理的都是@Retention(RetentionPolicy.RUNTIME)的注解，使用的是反射技术。而生成的<code>*hbm.xml</code>文件<strong>是需要在编译阶段完成。为此java在java7之前提供了apt工具及api</strong>，在java7及之后提供了JSR269 api。</p>
<h4 id="apt和jsr269的作用"><a href="#apt和jsr269的作用" class="headerlink" title="apt和jsr269的作用"></a>apt和jsr269的作用</h4><p>APT是一种处理注释的工具,<strong>它对源代码文件进行检测，并找出源文件中所包含的Annotation信息</strong>，然后针对Annotation信息进行额外的处理。<br>APT处理器在处理Annotation时可以根据源文件中的Annotation生成额外的源文件和其它的文件(文件具体内容由Annotation处理器的编写者决定),APT还会编译生成的源文件和原来的源文件，将它们一起生成class文件.使用APT主要的目的是简化开发者的工作量。<br>因为APT可以编译程序源代码的同时，生成一些附属文件(比如源文件、类文件、程序发布描述文件等)，这些附属文件的内容也都是与源代码相关的，换句话说，使用APT可以代替传统的对代码信息和附属文件的维护工作。<br>APT的相关api都在<code>com.sun.mirror</code> 包下，<strong>在jdk7及之后，apt的相关api就被废除了，代替的是JSR269</strong>。JSR269的api在 <code>javax.annotation.processing</code> and <code>javax.lang.model</code>包下。<br>所以以后开发注解处理器使用jsr269提供的api就可以了。</p>
<h4 id="实现"><a href="#实现" class="headerlink" title="实现"></a>实现</h4><ol>
<li>使用apt实现<br> 略</li>
<li><p>使用JSR269实现</p>
<ul>
<li>运行环境jdk1.8</li>
<li>Java提供的javac.exe工具有一个-processor选项，该选项可指定一个Annotation处理器，如果在编译java源文件的时候通过该选项指定了Annotation处理器，那么这个Annotation处理器，将可以在编译时提取并处理Java源文件中的Annotation。</li>
<li>每个Annotation处理器都需要实现javax.annotation.processing包下的Processor接口。不过实现该接口必须实现它里面所有方法，因此通常采用继承AbstractProcessor的方式来实现Annotation处理器，一个Annotation处理器可以处理一种或多种Annotation类型。</li>
</ul>
</li>
</ol>
<p>之前的错误认识：之前以为-processor选项需要指定注解处理器是一个*.java文件，其实是一个.class文件，既然是.class文件，那么肯定是编译过后的，所以需要单独写一个处理器程序annotation-processor，打成一个jar包，然后在使用注解的程序annotation中加入注解处理器依赖包annotation-processor.jar，在编译的时候指定处理器类即可。下面我会分别演示通过javac 命令和maven命令如何进行操作。</p>
<p>下面的项目会使用maven来构建，如果不是使用maven也可以，因为我也会演示如何通过javac 命令来执行注解处理器。</p>
<p>2.1 注解处理器程序annotation-processor</p>
<p>下面将定义三个Annotation类型，分别用于修饰持久化类，标识属性和普通属性。<br>修饰id注解</p>
<pre><code>package com.zlcook.processor.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//修饰id注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Id {
    String column();    //该id属性对应表中的列名
    String type();      //id属性类型
    String generator(); //使用的策略
}
</code></pre><p>修饰属性注解</p>
<pre><code>package com.zlcook.processor.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//修饰属性注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Property {
    String column();    //该属性对应表中的列名
    String type();      //id属性类型
}
</code></pre><p>修饰实体类注解</p>
<pre><code>package com.zlcook.processor.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//修饰实体类注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Persistent {
    String table();       //数据库中表名
}
</code></pre><p>处理上面三个注解的处理器HibernateAnnotationProcessor，根据注解生成对应的*.hbm.xml文件</p>
<pre><code>package com.zlcook.processor;
import java.io.FileOutputStream;
import java.io.PrintStream;
import java.util.LinkedHashSet;
import java.util.Set;
import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.ProcessingEnvironment;
import javax.annotation.processing.RoundEnvironment;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.Element;
import javax.lang.model.element.ElementKind;
import javax.lang.model.element.Name;
import javax.lang.model.element.TypeElement;
import com.zlcook.processor.annotation.Id;
import com.zlcook.processor.annotation.Persistent;
import com.zlcook.processor.annotation.Property;

/**
* 类说明:hiberante注解处理器，用于根据实体bean的注解生成*.hbm.xml文件，处理时期在编译阶段。
*/
public class HibernateAnnotationProcessor extends AbstractProcessor {

    @Override
    public synchronized void init(ProcessingEnvironment processingEnv) {
        // TODO Auto-generated method stub
        super.init(processingEnv);
        System.out.println(&quot;HibernateAnnotationProcessor注解处理器初始化完成..............&quot;);
    }
    @Override
    public boolean process(Set&lt;? extends TypeElement&gt; annotations, RoundEnvironment roundEnv) {

        //定义一个文件输出流，用于生成额外的文件
        PrintStream ps = null;
        try{
            //遍历每个被@Persistent修饰的class文件,使用RoundEnvironment来获取Annotation信息
            for( Element t : roundEnv.getElementsAnnotatedWith(Persistent.class)){
                //获取正在处理的类名
                Name clazzName = t.getSimpleName();
                //获取类定义前的@Persistent Annotation
                Persistent per = t.getAnnotation(Persistent.class);
                //创建文件输出流
                String fileName =clazzName+&quot;.hbm.xml&quot;;
                ps = new PrintStream(new FileOutputStream(fileName));
                 // 执行输出
                 ps.println(&quot;&lt;?xml version=\&quot;1.0\&quot;?&gt;&quot;);
                 ps.println(&quot;&lt;!DOCTYPE hibernate-mapping&quot;);
                 ps.println(&quot; PUBLIC \&quot;-// Hibernate/Hibernate Ma  pping DTD 3.0//EN\&quot;&quot;);
                 ps.println(&quot; \&quot;http:// hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\&quot;&gt;&quot;);
                 ps.println(&quot;&lt;hibernate-mapping&gt;&quot;);
                 ps.print(&quot; &lt;class name=\&quot;&quot; + t);
                 // 输出per的table()的值
                 ps.println(&quot;\&quot; table=\&quot;&quot; + per.table() + &quot;\&quot;&gt;&quot;);
                 //获取@Persistent修改类的各个属性字段。t.getEnclosedElements()获取该Elemet里定义的所有程序单元
                 for(Element ele : t.getEnclosedElements()){

                     //只处理成员变量上的Annotation，ele.getKind()返回所代表的的程序单元
                     if( ele.getKind() == ElementKind.FIELD){
                        //被id注解修饰的字段
                         Id idAno= ele.getAnnotation(Id.class);
                         if( idAno != null){
                             String column =idAno.column();
                             String type =idAno.type();
                             String generator = idAno.generator();
                             // 执行输出
                               ps.println(&quot; &lt;id name=\&quot;&quot; + ele.getSimpleName() + &quot;\&quot; column=\&quot;&quot; + column + &quot;\&quot; type=\&quot;&quot; + type + &quot;\&quot;&gt;&quot;);
                               ps.println(&quot; &lt;generator class=\&quot;&quot; + generator + &quot;\&quot;/&gt;&quot;);
                               ps.println(&quot; &lt;/id&gt;&quot;);
                         }

                         //被Property注解修饰的字段
                         Property p = ele.getAnnotation(Property.class);
                         if( p !=null){
                             // 执行输出
                             ps.println(&quot; &lt;property name=\&quot;&quot; + ele.getSimpleName() + &quot;\&quot; column=\&quot;&quot; + p.column() + &quot;\&quot;type=\&quot;&quot; + p.type() + &quot;\&quot;/&gt;&quot;);
                         }
                     }
                 }// end for
                 ps.println(&quot; &lt;/class&gt;&quot;);
                 ps.println(&quot;&lt;/hibernate-mapping&gt;&quot;);
            }// end for 

        }catch(Exception e){
            e.printStackTrace();
        }finally {
            if(ps!=null){
                try{
                    ps.close();
                }catch(Exception e){
                    e.printStackTrace();
                }
            }
        }
        return true;
    }
    /** 
     * 这里必须指定，这个注解处理器是注册给哪个注解的。注意，它的返回值是一个字符串的集合，包含本处理器想要处理的注解类型的合法全称 
     * @return  注解器所支持的注解类型集合，如果没有这样的类型，则返回一个空集合 
     */  
    @Override  
    public Set&lt;String&gt; getSupportedAnnotationTypes() {  
        Set&lt;String&gt; annotataions = new LinkedHashSet&lt;String&gt;();  
        annotataions.add(Id.class.getCanonicalName());  
        annotataions.add(Property.class.getCanonicalName());  
        annotataions.add(Persistent.class.getCanonicalName());  
        return annotataions;  
    }  

    /** 
     * 指定使用的Java版本，通常这里返回SourceVersion.latestSupported()，默认返回SourceVersion.RELEASE_6 
     * @return  使用的Java版本 
     */
    @Override  
    public SourceVersion getSupportedSourceVersion() {  
        return SourceVersion.latestSupported();  
    }  
}
</code></pre><p>注解程序写完打包成jar文件。</p>
<pre><code>打包成jar文件为使用注解处理器的程序提供依赖。
使用maven构建直接使用mvn install，这样就将项目打包成jar依赖到本地仓库中了。
使用java命令打包成jar文件：先用javac编译成.class文件，在使用jar命令打包成jar文件。
</code></pre><p>使用java命令打包成jar文件</p>
<p>源文件位置：E:\EclipseWorkspace\Cnu\annotation-processor\src\main\java，编译后.class文件存放到classes文件夹下，使用javac命令编译源代码需要指定.java文件，为了避免在命令行中敲太多代码，所以将要编译的源代码文件都列在了sources.list文件中。</p>
<p>源代码文件及编译后文件存放位置：<br><img src="http://ozypoe1ag.bkt.clouddn.com/201711301308_870.png" alt=""><br>source.list文件内容：<br><img src="http://ozypoe1ag.bkt.clouddn.com/201711301310_251.png" alt=""></p>
<p>执行编译命令javac<br>javac命令中指定UTF-8编码、编译后文件存放位置、需要编译的源文件</p>
<pre><code>E:\EclipseWorkspace\Cnu\annotation-processor\src\main\java&gt;javac -encoding UTF-8
-d classes @sources.list
</code></pre><p>执行打包命令jar<br>将classes中的编译文件，打包成annotation-processor.jar文件。进入到classes目录中执行如下jar命令</p>
<pre><code>E:\EclipseWorkspace\Cnu\annotation-processor\src\main\java\classes&gt;jar -cvf annotation-processor.jar com
</code></pre><h4 id="注解使用程序annotation"><a href="#注解使用程序annotation" class="headerlink" title="注解使用程序annotation"></a>注解使用程序annotation</h4><p>添加annotation-processor.jar依赖<br>注解处理程序写完并打成了jar包，将jar引入到annotation中使用。<br>使用maven则在pom.xml中声明一个依赖。因为该依赖只在编译阶段才使用所以范围采用provied。更多maven依赖范围</p>
<pre><code>&lt;dependency&gt;
    &lt;groupId&gt;com.zlcook.processor&lt;/groupId&gt;
    &lt;artifactId&gt;annotation-processor&lt;/artifactId&gt;
    &lt;version&gt;0.0.5-SNAPSHOT&lt;/version&gt;
    &lt;scope&gt;provided&lt;/scope&gt;
&lt;/dependency&gt;
</code></pre><p>没有使用maven构建，只要保证运行项目时annotation-processor.jar在classpath路径中就行。根据你是用的开发工具而定，使用eclipse则将jar添加到编译路径中。</p>
<p>编写项目annotation</p>
<p>为了演示自定义注解和注解处理的作用：在编译时根据注解生成<code>*.hbm.xml</code>文件，所以写一个类Person就可以了。代码如下：<br>    package com.zlcook.annotation.bean;<br>    import com.zlcook.processor.annotation.Id;<br>    import com.zlcook.processor.annotation.Persistent;<br>    import com.zlcook.processor.annotation.Property;</p>
<pre><code>/**
* @author 周亮 
* @version 创建时间：2017年2月19日 下午10:05:05
* 类说明:使用注解完成映射的实体类
*/
@Persistent(table=&quot;person_inf&quot;)
public class Person {
     @Id(column = &quot;person_id&quot;, type = &quot;integer&quot;, generator = &quot;identity&quot;)
     private int id;
     @Property(column = &quot;person_name&quot;, type = &quot;string&quot;)
     private String name;
     @Property(column = &quot;person_age&quot;, type = &quot;integer&quot;)
     private int age;
     public int getId() {
      return id;
     }
     public void setId(int id) {
      this.id = id;
     }
     public String getName() {
      return name;
     }
     public void setName(String name) {
      this.name = name;
     }
     public int getAge() {
      return age;
     }
     public void setAge(int age) {
      this.age = age;
     }
}
</code></pre><h4 id="运行效果演示"><a href="#运行效果演示" class="headerlink" title="运行效果演示"></a>运行效果演示</h4><p>下面就使用javac命令和maven命令编译annotation项目，来演示HibernateAnnotationProcessor处理器的效果。看能不能在编译期生成Person.hbm.xml文件。</p>
<ul>
<li><p>javac编译</p>
<ul>
<li>将annotation-processor.jar拷贝到annotaion的源代码位置，当然你也可以拷贝到其它地方，主要为了引用方便。再新建一个存放编译文件的文件夹classes。如下：<br><img src="http://ozypoe1ag.bkt.clouddn.com/201711301315_531.png" alt=""></li>
<li><p>在该目录下执行javac 命令<br>javac命令中指定UTF-8编码、编译后文件存放位置、编译过程中依赖的文件、注解处理器类、需要编译的源文件</p>
<pre><code>E:\EclipseWorkspace\Cnu\annotation\src\main\java&gt;javac -encoding UTF-8 -d classes -classpath annotation-processor.jar -processor com.zlcook.processor.HibernateAnnotationProcessor com/zlcook/annotation/bean/Person.java
</code></pre></li>
<li><p>执行后效果<br>当前目录下出现了一个Person.hbm.xml文件<br><img src="http://ozypoe1ag.bkt.clouddn.com/201711301317_939.png" alt=""></p>
</li>
</ul>
</li>
<li><p>Maven编译</p>
</li>
</ul>
<p>使用maven编译，唯一需要动的的就是指明编译过程中需要的注解处理程序HibernateAnnotationProcessor。为此需要设置maven-compiler-plugin插件中compiler目标的参数。<br>在pom.xml中设置如下：</p>
<pre><code>&lt;build&gt;
&lt;plugins&gt;
&lt;plugin&gt;
    &lt;artifactId&gt;maven-compiler-plugin&lt;/artifactId&gt;
    &lt;version&gt;3.1&lt;/version&gt;
    &lt;executions&gt;
      &lt;execution&gt;
        &lt;id&gt;default-compile&lt;/id&gt;
        &lt;phase&gt;compile&lt;/phase&gt;
        &lt;goals&gt;
          &lt;goal&gt;compile&lt;/goal&gt;
        &lt;/goals&gt;
        &lt;configuration&gt;
         &lt;source&gt;1.8&lt;/source&gt;
         &lt;target&gt;1.8&lt;/target&gt;
          &lt;annotationProcessors&gt;
            &lt;annotationProcessor&gt;com.zlcook.processor.HibernateAnnotationProcessor&lt;/annotationProcessor&gt;
         &lt;/annotationProcessors&gt; 
        &lt;/configuration&gt;
      &lt;/execution&gt;
    &lt;/executions&gt;
  &lt;/plugin&gt;
&lt;/plugins&gt;
&lt;/build&gt;
</code></pre><p>执行maven命令</p>
<pre><code>mvn clean compile
</code></pre><p>执行完成后在项目根目录下就出现了Person.hbm.xml文件。</p>
<p><code>Person.hbm.xml</code>内容如下：</p>
<pre><code>&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;!DOCTYPE hibernate-mapping
PUBLIC &quot;-// Hibernate/Hibernate Ma  pping DTD 3.0//EN&quot;
&quot;http:// hibernate.sourceforge.net/hibernate-mapping-3.0.dtd&quot;&gt;
&lt;hibernate-mapping&gt;
&lt;class name=&quot;com.zlcook.annotation.bean.Person&quot; table=&quot;person_inf&quot;&gt;
&lt;id name=&quot;id&quot; column=&quot;person_id&quot; type=&quot;integer&quot;&gt;
&lt;generator class=&quot;identity&quot;/&gt;
&lt;/id&gt;
&lt;property name=&quot;name&quot; column=&quot;person_name&quot;type=&quot;string&quot;/&gt;
&lt;property name=&quot;age&quot; column=&quot;person_age&quot;type=&quot;integer&quot;/&gt;
&lt;/class&gt;
&lt;/hibernate-mapping&gt;
</code></pre><h3 id="java注解脑图"><a href="#java注解脑图" class="headerlink" title="java注解脑图"></a>java注解脑图</h3><p><img src="http://ozypoe1ag.bkt.clouddn.com/201711301320_96.jpg" alt=""></p>
<p>本文内容来源于网络，来源信息如下：</p>
<blockquote>
<p>作者：zlcook<br>链接：<a href="http://www.jianshu.com/p/28edf5352b63" target="_blank" rel="noopener">http://www.jianshu.com/p/28edf5352b63</a><br>來源：简书</p>
</blockquote>
<ul>
<li>关于注解处理器，更深入内容可以参考<a href="http://blog.csdn.net/qinxiandiqi/article/details/49182735" target="_blank" rel="noopener">http://blog.csdn.net/qinxiandiqi/article/details/49182735</a></li>
</ul>

      
    </div>
    
    
    

    

    
      <div>
        <div style="padding: 10px 0; margin: 20px auto; width: 90%; text-align: center;">
  <div>赏钱吃饭</div>
  <button id="rewardButton" disable="enable" onclick="var qr = document.getElementById('QR'); if (qr.style.display === 'none') {qr.style.display='block';} else {qr.style.display='none'}">
    <span>Donate</span>
  </button>
  <div id="QR" style="display: none;">

    
      <div id="wechat" style="display: inline-block">
        <img id="wechat_qr" src="/kunkun/images/weixin.png" alt="hasaki WeChat Pay"/>
        <p>WeChat Pay</p>
      </div>
    

    
      <div id="alipay" style="display: inline-block">
        <img id="alipay_qr" src="/kunkun/images/zhifubao.png" alt="hasaki Alipay"/>
        <p>Alipay</p>
      </div>
    

    

  </div>
</div>

      </div>
    

    

    <footer class="post-footer">
      
        <div class="post-tags">
          
            <a href="/kunkun/tags/java/" rel="tag"># java</a>
          
            <a href="/kunkun/tags/注解/" rel="tag"># 注解</a>
          
        </div>
      

      
      
      

      
        <div class="post-nav">
          <div class="post-nav-next post-nav-item">
            
              <a href="/kunkun/2017/11/30/markdown插入图片/" rel="next" title="markdown插入图片">
                <i class="fa fa-chevron-left"></i> markdown插入图片
              </a>
            
          </div>

          <span class="post-nav-divider"></span>

          <div class="post-nav-prev post-nav-item">
            
              <a href="/kunkun/2017/11/30/java泛型/" rel="prev" title="java泛型">
                java泛型 <i class="fa fa-chevron-right"></i>
              </a>
            
          </div>
        </div>
      

      
      
    </footer>
  </div>
  
  
  
  </article>



    <div class="post-spread">
      
    </div>
  </div>


          </div>
          


          
  <div class="comments" id="comments">
    
      <div id="hypercomments_widget"></div>
    
  </div>


        </div>
        
          
  
  <div class="sidebar-toggle">
    <div class="sidebar-toggle-line-wrap">
      <span class="sidebar-toggle-line sidebar-toggle-line-first"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-middle"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-last"></span>
    </div>
  </div>

  <aside id="sidebar" class="sidebar">
    
    <div class="sidebar-inner">

      

      
        <ul class="sidebar-nav motion-element">
          <li class="sidebar-nav-toc sidebar-nav-active" data-target="post-toc-wrap" >
            文章目录
          </li>
          <li class="sidebar-nav-overview" data-target="site-overview">
            站点概览
          </li>
        </ul>
      

      <section class="site-overview sidebar-panel">
        <div class="site-author motion-element" itemprop="author" itemscope itemtype="http://schema.org/Person">
          <img class="site-author-image" itemprop="image"
               src="/kunkun/images/touxiang.jpg"
               alt="hasaki" />
          <p class="site-author-name" itemprop="name">hasaki</p>
           
              <p class="site-description motion-element" itemprop="description">求知若渴，虚心若愚</p>
          
        </div>
        <nav class="site-state motion-element">

          
            <div class="site-state-item site-state-posts">
              <a href="/kunkun/archives/">
                <span class="site-state-item-count">7</span>
                <span class="site-state-item-name">日志</span>
              </a>
            </div>
          

          
            
            
            <div class="site-state-item site-state-categories">
              <a href="/kunkun/categories/index.html">
                <span class="site-state-item-count">6</span>
                <span class="site-state-item-name">分类</span>
              </a>
            </div>
          

          
            
            
            <div class="site-state-item site-state-tags">
              <a href="/kunkun/tags/index.html">
                <span class="site-state-item-count">17</span>
                <span class="site-state-item-name">标签</span>
              </a>
            </div>
          

        </nav>

        

        <div class="links-of-author motion-element">
          
            
              <span class="links-of-author-item">
                <a href="https://github.com/kun95" target="_blank" title="GitHub">
                  
                    
                      GitHub
                    
                </a>
              </span>
            
              <span class="links-of-author-item">
                <a href="https://www.zhihu.com/people/kunkuna-17/activities" target="_blank" title="知乎">
                  
                    
                      知乎
                    
                </a>
              </span>
            
          
        </div>

        
        

        
        

        


      </section>

      
      <!--noindex-->
        <section class="post-toc-wrap motion-element sidebar-panel sidebar-panel-active">
          <div class="post-toc">

            
              
            

            
              <div class="post-toc-content"><ol class="nav"><li class="nav-item nav-level-3"><a class="nav-link" href="#注解是什么"><span class="nav-number">1.</span> <span class="nav-text">注解是什么</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#注解优缺点"><span class="nav-number">2.</span> <span class="nav-text">注解优缺点</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#优点"><span class="nav-number">2.1.</span> <span class="nav-text">优点</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#缺点"><span class="nav-number">2.2.</span> <span class="nav-text">缺点</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#说明"><span class="nav-number">3.</span> <span class="nav-text">说明</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#基本知识"><span class="nav-number">4.</span> <span class="nav-text">基本知识</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#5个基本Annotation"><span class="nav-number">4.1.</span> <span class="nav-text">5个基本Annotation</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#6个元Annotation"><span class="nav-number">4.2.</span> <span class="nav-text">6个元Annotation</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#如何自定义注解"><span class="nav-number">5.</span> <span class="nav-text">如何自定义注解</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#一个简单的注解"><span class="nav-number">5.1.</span> <span class="nav-text">一个简单的注解</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#带成员变量的注解"><span class="nav-number">5.2.</span> <span class="nav-text">带成员变量的注解</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#结论"><span class="nav-number">5.3.</span> <span class="nav-text">结论</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#如何提取注解信息"><span class="nav-number">6.</span> <span class="nav-text">如何提取注解信息</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#Java8新增的重复注解"><span class="nav-number">7.</span> <span class="nav-text">Java8新增的重复注解</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#java8之前实现思路"><span class="nav-number">7.1.</span> <span class="nav-text">java8之前实现思路</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#java8之后实现重复注解"><span class="nav-number">7.2.</span> <span class="nav-text">java8之后实现重复注解</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#获取重复注解方法"><span class="nav-number">7.3.</span> <span class="nav-text">获取重复注解方法</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#Java8新增的Type-Annotation注解"><span class="nav-number">8.</span> <span class="nav-text">Java8新增的Type Annotation注解</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#介绍"><span class="nav-number">8.1.</span> <span class="nav-text">介绍</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#案例"><span class="nav-number">8.2.</span> <span class="nav-text">案例</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#编译时处理Annotation"><span class="nav-number">9.</span> <span class="nav-text">编译时处理Annotation</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#需求"><span class="nav-number">9.1.</span> <span class="nav-text">需求</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#可用api"><span class="nav-number">9.2.</span> <span class="nav-text">可用api</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#apt和jsr269的作用"><span class="nav-number">9.3.</span> <span class="nav-text">apt和jsr269的作用</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#实现"><span class="nav-number">9.4.</span> <span class="nav-text">实现</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#注解使用程序annotation"><span class="nav-number">9.5.</span> <span class="nav-text">注解使用程序annotation</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#运行效果演示"><span class="nav-number">9.6.</span> <span class="nav-text">运行效果演示</span></a></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#java注解脑图"><span class="nav-number">10.</span> <span class="nav-text">java注解脑图</span></a></li></ol></div>
            

          </div>
        </section>
      <!--/noindex-->
      

      

    </div>
  </aside>


        
      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="footer-inner">
        <div class="copyright" >
  
  &copy; 
  <span itemprop="copyrightYear">2017</span>
  <span class="with-love">
    <i class="fa fa-heart"></i>
  </span>
  <span class="author" itemprop="copyrightHolder">hasaki</span>
</div>


<!--
<div class="powered-by">
  由 <a class="theme-link" href="https://hexo.io">Hexo</a> 强力驱动
</div>

<div class="theme-info">
  主题 -
  <a class="theme-link" href="https://github.com/iissnan/hexo-theme-next">
    NexT.Mist
  </a>
</div>
-->


        
<div class="busuanzi-count">
  <script async src="https://dn-lbstatics.qbox.me/busuanzi/2.3/busuanzi.pure.mini.js"></script>

  
    <span class="site-uv">
      本站访客数
      <span class="busuanzi-value" id="busuanzi_value_site_uv"></span>
      
    </span>
  

  
    <span class="site-pv">
      本站总访问量
      <span class="busuanzi-value" id="busuanzi_value_site_pv"></span>
      
    </span>
  
</div>


        
      </div>
    </footer>

    
      <div class="back-to-top">
        <i class="fa fa-arrow-up"></i>
        
      </div>
    

  </div>

  

<script type="text/javascript">
  if (Object.prototype.toString.call(window.Promise) !== '[object Function]') {
    window.Promise = null;
  }
</script>









  












  
  <script type="text/javascript" src="/kunkun/lib/jquery/index.js?v=2.1.3"></script>

  
  <script type="text/javascript" src="/kunkun/lib/fastclick/lib/fastclick.min.js?v=1.0.6"></script>

  
  <script type="text/javascript" src="/kunkun/lib/jquery_lazyload/jquery.lazyload.js?v=1.9.7"></script>

  
  <script type="text/javascript" src="/kunkun/lib/velocity/velocity.min.js?v=1.2.1"></script>

  
  <script type="text/javascript" src="/kunkun/lib/velocity/velocity.ui.min.js?v=1.2.1"></script>

  
  <script type="text/javascript" src="/kunkun/lib/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>


  


  <script type="text/javascript" src="/kunkun/js/src/utils.js?v=5.1.2"></script>

  <script type="text/javascript" src="/kunkun/js/src/motion.js?v=5.1.2"></script>



  
  

  
  <script type="text/javascript" src="/kunkun/js/src/scrollspy.js?v=5.1.2"></script>
<script type="text/javascript" src="/kunkun/js/src/post-details.js?v=5.1.2"></script>



  


  <script type="text/javascript" src="/kunkun/js/src/bootstrap.js?v=5.1.2"></script>



  


  




	

		<script type="text/javascript">
		_hcwp = window._hcwp || [];

		_hcwp.push({widget:"Bloggerstream", widget_id: 98413, selector:".hc-comment-count", label: "{\%COUNT%\}" });

		
		_hcwp.push({widget:"Stream", widget_id: 98413, xid: "2017/11/30/java注解知识梳理/"});
		

		(function() {
		if("HC_LOAD_INIT" in window)return;
		HC_LOAD_INIT = true;
		var lang = (navigator.language || navigator.systemLanguage || navigator.userLanguage || "en").substr(0, 2).toLowerCase();
		var hcc = document.createElement("script"); hcc.type = "text/javascript"; hcc.async = true;
		hcc.src = ("https:" == document.location.protocol ? "https" : "http")+"://w.hypercomments.com/widget/hc/98413/"+lang+"/widget.js";
		var s = document.getElementsByTagName("script")[0];
		s.parentNode.insertBefore(hcc, s.nextSibling);
		})();
		</script>

	










  

  <script type="text/javascript">
    // Popup Window;
    var isfetched = false;
    var isXml = true;
    // Search DB path;
    var search_path = "search.xml";
    if (search_path.length === 0) {
      search_path = "search.xml";
    } else if (/json$/i.test(search_path)) {
      isXml = false;
    }
    var path = "/kunkun/" + search_path;
    // monitor main search box;

    var onPopupClose = function (e) {
      $('.popup').hide();
      $('#local-search-input').val('');
      $('.search-result-list').remove();
      $('#no-result').remove();
      $(".local-search-pop-overlay").remove();
      $('body').css('overflow', '');
    }

    function proceedsearch() {
      $("body")
        .append('<div class="search-popup-overlay local-search-pop-overlay"></div>')
        .css('overflow', 'hidden');
      $('.search-popup-overlay').click(onPopupClose);
      $('.popup').toggle();
      var $localSearchInput = $('#local-search-input');
      $localSearchInput.attr("autocapitalize", "none");
      $localSearchInput.attr("autocorrect", "off");
      $localSearchInput.focus();
    }

    // search function;
    var searchFunc = function(path, search_id, content_id) {
      'use strict';

      // start loading animation
      $("body")
        .append('<div class="search-popup-overlay local-search-pop-overlay">' +
          '<div id="search-loading-icon">' +
          '<i class="fa fa-spinner fa-pulse fa-5x fa-fw"></i>' +
          '</div>' +
          '</div>')
        .css('overflow', 'hidden');
      $("#search-loading-icon").css('margin', '20% auto 0 auto').css('text-align', 'center');

      $.ajax({
        url: path,
        dataType: isXml ? "xml" : "json",
        async: true,
        success: function(res) {
          // get the contents from search data
          isfetched = true;
          $('.popup').detach().appendTo('.header-inner');
          var datas = isXml ? $("entry", res).map(function() {
            return {
              title: $("title", this).text(),
              content: $("content",this).text(),
              url: $("url" , this).text()
            };
          }).get() : res;
          var input = document.getElementById(search_id);
          var resultContent = document.getElementById(content_id);
          var inputEventFunction = function() {
            var searchText = input.value.trim().toLowerCase();
            var keywords = searchText.split(/[\s\-]+/);
            if (keywords.length > 1) {
              keywords.push(searchText);
            }
            var resultItems = [];
            if (searchText.length > 0) {
              // perform local searching
              datas.forEach(function(data) {
                var isMatch = false;
                var hitCount = 0;
                var searchTextCount = 0;
                var title = data.title.trim();
                var titleInLowerCase = title.toLowerCase();
                var content = data.content.trim().replace(/<[^>]+>/g,"");
                var contentInLowerCase = content.toLowerCase();
                var articleUrl = decodeURIComponent(data.url);
                var indexOfTitle = [];
                var indexOfContent = [];
                // only match articles with not empty titles
                if(title != '') {
                  keywords.forEach(function(keyword) {
                    function getIndexByWord(word, text, caseSensitive) {
                      var wordLen = word.length;
                      if (wordLen === 0) {
                        return [];
                      }
                      var startPosition = 0, position = [], index = [];
                      if (!caseSensitive) {
                        text = text.toLowerCase();
                        word = word.toLowerCase();
                      }
                      while ((position = text.indexOf(word, startPosition)) > -1) {
                        index.push({position: position, word: word});
                        startPosition = position + wordLen;
                      }
                      return index;
                    }

                    indexOfTitle = indexOfTitle.concat(getIndexByWord(keyword, titleInLowerCase, false));
                    indexOfContent = indexOfContent.concat(getIndexByWord(keyword, contentInLowerCase, false));
                  });
                  if (indexOfTitle.length > 0 || indexOfContent.length > 0) {
                    isMatch = true;
                    hitCount = indexOfTitle.length + indexOfContent.length;
                  }
                }

                // show search results

                if (isMatch) {
                  // sort index by position of keyword

                  [indexOfTitle, indexOfContent].forEach(function (index) {
                    index.sort(function (itemLeft, itemRight) {
                      if (itemRight.position !== itemLeft.position) {
                        return itemRight.position - itemLeft.position;
                      } else {
                        return itemLeft.word.length - itemRight.word.length;
                      }
                    });
                  });

                  // merge hits into slices

                  function mergeIntoSlice(text, start, end, index) {
                    var item = index[index.length - 1];
                    var position = item.position;
                    var word = item.word;
                    var hits = [];
                    var searchTextCountInSlice = 0;
                    while (position + word.length <= end && index.length != 0) {
                      if (word === searchText) {
                        searchTextCountInSlice++;
                      }
                      hits.push({position: position, length: word.length});
                      var wordEnd = position + word.length;

                      // move to next position of hit

                      index.pop();
                      while (index.length != 0) {
                        item = index[index.length - 1];
                        position = item.position;
                        word = item.word;
                        if (wordEnd > position) {
                          index.pop();
                        } else {
                          break;
                        }
                      }
                    }
                    searchTextCount += searchTextCountInSlice;
                    return {
                      hits: hits,
                      start: start,
                      end: end,
                      searchTextCount: searchTextCountInSlice
                    };
                  }

                  var slicesOfTitle = [];
                  if (indexOfTitle.length != 0) {
                    slicesOfTitle.push(mergeIntoSlice(title, 0, title.length, indexOfTitle));
                  }

                  var slicesOfContent = [];
                  while (indexOfContent.length != 0) {
                    var item = indexOfContent[indexOfContent.length - 1];
                    var position = item.position;
                    var word = item.word;
                    // cut out 100 characters
                    var start = position - 20;
                    var end = position + 80;
                    if(start < 0){
                      start = 0;
                    }
                    if (end < position + word.length) {
                      end = position + word.length;
                    }
                    if(end > content.length){
                      end = content.length;
                    }
                    slicesOfContent.push(mergeIntoSlice(content, start, end, indexOfContent));
                  }

                  // sort slices in content by search text's count and hits' count

                  slicesOfContent.sort(function (sliceLeft, sliceRight) {
                    if (sliceLeft.searchTextCount !== sliceRight.searchTextCount) {
                      return sliceRight.searchTextCount - sliceLeft.searchTextCount;
                    } else if (sliceLeft.hits.length !== sliceRight.hits.length) {
                      return sliceRight.hits.length - sliceLeft.hits.length;
                    } else {
                      return sliceLeft.start - sliceRight.start;
                    }
                  });

                  // select top N slices in content

                  var upperBound = parseInt('1');
                  if (upperBound >= 0) {
                    slicesOfContent = slicesOfContent.slice(0, upperBound);
                  }

                  // highlight title and content

                  function highlightKeyword(text, slice) {
                    var result = '';
                    var prevEnd = slice.start;
                    slice.hits.forEach(function (hit) {
                      result += text.substring(prevEnd, hit.position);
                      var end = hit.position + hit.length;
                      result += '<b class="search-keyword">' + text.substring(hit.position, end) + '</b>';
                      prevEnd = end;
                    });
                    result += text.substring(prevEnd, slice.end);
                    return result;
                  }

                  var resultItem = '';

                  if (slicesOfTitle.length != 0) {
                    resultItem += "<li><a href='" + articleUrl + "' class='search-result-title'>" + highlightKeyword(title, slicesOfTitle[0]) + "</a>";
                  } else {
                    resultItem += "<li><a href='" + articleUrl + "' class='search-result-title'>" + title + "</a>";
                  }

                  slicesOfContent.forEach(function (slice) {
                    resultItem += "<a href='" + articleUrl + "'>" +
                      "<p class=\"search-result\">" + highlightKeyword(content, slice) +
                      "...</p>" + "</a>";
                  });

                  resultItem += "</li>";
                  resultItems.push({
                    item: resultItem,
                    searchTextCount: searchTextCount,
                    hitCount: hitCount,
                    id: resultItems.length
                  });
                }
              })
            };
            if (keywords.length === 1 && keywords[0] === "") {
              resultContent.innerHTML = '<div id="no-result"><i class="fa fa-search fa-5x" /></div>'
            } else if (resultItems.length === 0) {
              resultContent.innerHTML = '<div id="no-result"><i class="fa fa-frown-o fa-5x" /></div>'
            } else {
              resultItems.sort(function (resultLeft, resultRight) {
                if (resultLeft.searchTextCount !== resultRight.searchTextCount) {
                  return resultRight.searchTextCount - resultLeft.searchTextCount;
                } else if (resultLeft.hitCount !== resultRight.hitCount) {
                  return resultRight.hitCount - resultLeft.hitCount;
                } else {
                  return resultRight.id - resultLeft.id;
                }
              });
              var searchResultList = '<ul class=\"search-result-list\">';
              resultItems.forEach(function (result) {
                searchResultList += result.item;
              })
              searchResultList += "</ul>";
              resultContent.innerHTML = searchResultList;
            }
          }

          if ('auto' === 'auto') {
            input.addEventListener('input', inputEventFunction);
          } else {
            $('.search-icon').click(inputEventFunction);
            input.addEventListener('keypress', function (event) {
              if (event.keyCode === 13) {
                inputEventFunction();
              }
            });
          }

          // remove loading animation
          $(".local-search-pop-overlay").remove();
          $('body').css('overflow', '');

          proceedsearch();
        }
      });
    }

    // handle and trigger popup window;
    $('.popup-trigger').click(function(e) {
      e.stopPropagation();
      if (isfetched === false) {
        searchFunc(path, 'local-search-input', 'local-search-result');
      } else {
        proceedsearch();
      };
    });

    $('.popup-btn-close').click(onPopupClose);
    $('.popup').click(function(e){
      e.stopPropagation();
    });
    $(document).on('keyup', function (event) {
      var shouldDismissSearchPopup = event.which === 27 &&
        $('.search-popup').is(':visible');
      if (shouldDismissSearchPopup) {
        onPopupClose();
      }
    });
  </script>





  

  

  

  

  

  


  <script type="text/javascript" src="http://kun95.gitee.io/kunkun/js/src/love.js"></script>
</body>
</html>
